<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>search using names of cities, towns, etc. to try to find matches and get FIPS helper used by name2fips() — fips_place_from_placename • EJAM</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="search using names of cities, towns, etc. to try to find matches and get FIPS helper used by name2fips() — fips_place_from_placename"><meta name="description" content="search using names of cities, towns, etc. to try to find matches and get FIPS
helper used by name2fips()"><meta property="og:description" content="search using names of cities, towns, etc. to try to find matches and get FIPS
helper used by name2fips()"><meta property="og:image" content="https://usepa.github.io/EJAM/logo.svg"></head><body>
    <a href="#main" class="visually-hidden-focusable">Skip to contents</a>


    <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

    <a class="navbar-brand me-2" href="../index.html">EJAM</a>

    <small class="nav-text text-warning me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">2.32.0</small>


    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>

    <div id="navbar" class="collapse navbar-collapse ms-3">
      <ul class="navbar-nav me-auto"><li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
<li class="nav-item dropdown">
  <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>Overview for EJAM Users</h6></li>
    <li><a class="dropdown-item" href="../articles/0_whatis.html">What is EJAM</a></li>
    <li><a class="dropdown-item" href="../articles/0_webapp.html">Using EJAM</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>For analysts using R</h6></li>
    <li><a class="dropdown-item" href="../articles/1_installing.html">Installing the EJAM R package</a></li>
    <li><a class="dropdown-item" href="../articles/2_quickstart.html">Quick Start Guide</a></li>
    <li><a class="dropdown-item" href="../articles/3_analyzing.html">Basics of Using EJAM for Analysis in RStudio</a></li>
    <li><a class="dropdown-item" href="../articles/4_advanced.html">Advanced Features</a></li>
  </ul></li>
<li class="nav-item"><a class="nav-link" href="../news/index.html">Changelog</a></li>
      </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
 <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
<li class="nav-item"><a class="external-link nav-link" href="https://github.com/USEPA/EJAM/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
      </ul></div>


  </div>
</nav><div class="container template-reference-topic">
<div class="row">
  <main id="main" class="col-md-9"><div class="page-header">
      <img src="../logo.svg" class="logo" alt=""><h1>search using names of cities, towns, etc. to try to find matches and get FIPS helper used by name2fips()</h1>
      <small class="dont-index">Source: <a href="https://github.com/USEPA/EJAM/blob/HEAD/R/FIPS_FUNCTIONS.R" class="external-link"><code>R/FIPS_FUNCTIONS.R</code></a></small>
      <div class="d-none name"><code>fips_place_from_placename.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>search using names of cities, towns, etc. to try to find matches and get FIPS
helper used by name2fips()</p>
    </div>

    <div class="section level2">
    <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">fips_place_from_placename</span><span class="op">(</span></span>
<span>  <span class="va">place_st</span>,</span>
<span>  geocoding <span class="op">=</span> <span class="cn">FALSE</span>,</span>
<span>  exact <span class="op">=</span> <span class="cn">FALSE</span>,</span>
<span>  usegrep <span class="op">=</span> <span class="cn">FALSE</span>,</span>
<span>  verbose <span class="op">=</span> <span class="cn">TRUE</span></span>
<span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>


<dl><dt id="arg-place-st">place_st<a class="anchor" aria-label="anchor" href="#arg-place-st"></a></dt>
<dd><p>vector of place names in format like "yonkers, ny" or "Chelsea city, MA"</p></dd>


<dt id="arg-geocoding">geocoding<a class="anchor" aria-label="anchor" href="#arg-geocoding"></a></dt>
<dd><p>set to TRUE to use a geocoding service to try to find hits</p></dd>


<dt id="arg-exact">exact<a class="anchor" aria-label="anchor" href="#arg-exact"></a></dt>
<dd><p>FALSE is to allow partial matching</p></dd>


<dt id="arg-usegrep">usegrep<a class="anchor" aria-label="anchor" href="#arg-usegrep"></a></dt>
<dd><p>DRAFT PARAM if exact=T, usegrep if TRUE will use the helper function fips_place_from_placename_grep()</p></dd>


<dt id="arg-verbose">verbose<a class="anchor" aria-label="anchor" href="#arg-verbose"></a></dt>
<dd><p>prints more to console about possible hits for each queried place name</p></dd>

</dl></div>
    <div class="section level2">
    <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
    <p>prints a table of possible hits but returns just the vector of fips</p>
    </div>
    <div class="section level2">
    <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
    <p>helper used by <code><a href="name2fips.html">name2fips()</a></code></p>
<p>Finding places by name is tricky because the master list <a href="censusplaces.html">censusplaces</a> names places
using the words city, town, township, village, borrough, and CDP
while most people will not think to include that qualifier as part of a query.</p>
<p>Also, about 300 places like "Salt Lake City" have the word "City" as an essential part
of their actual name, so those are listed in that table in the format, "Salt Lake City city"</p>
<p>Also, in some cases the exact same town or township name occurs more than once in a State so
a query by name and state is not always naming a unique place. This function does not
currently distinguish between those. This is relatively rare - out of 38,000 place names,
fewer than 600 unique place-state pairs appear more than once, and fewer than 150 of those appear
more than twice in the same state.
Cases with 4+ duplicates in a state arise only for towns and townships.
Chula Vista CDP, TX and San Antonio comunidad, PR each occur three times.
All other duplicates are where a CDP, borough, etc. occurs twice in a state.
Almost all duplicates are in PA, WI, MI or MN.
Pennsylvania in particular has many frequently reused township names:
In that state, these place names occur more than 15 times each:
Franklin township, Union township, Washington township, Jackson township.
There are more than 500 unique name-state pairs that are reused within a state.</p>
    </div>

  </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
    </nav></aside></div>


    <footer><div class="pkgdown-footer-left">
  <p>US EPA 2024</p>
</div>

<div class="pkgdown-footer-right">
  <p>EJAM Version 2.32.0</p>
</div>

    </footer></div>





  </body></html>

